home *** CD-ROM | disk | FTP | other *** search
/ PC Home 109 / PC Home 109.iso / data1.cab / IDAPI_Files / IDAPI / READLINK.TXT < prev    next >
Encoding:
Text File  |  2001-03-02  |  10.2 KB  |  288 lines
  1.          WELCOME TO BORLAND SQL LINKS 2.5 FOR WINDOWS
  2.          --------------------------------------------
  3.  
  4. This file contains important, late-breaking information 
  5. about Borland SQL Links for Windows, including revisions 
  6. to the documentation.  Information in this file supersedes 
  7. information in the SQL Links documentation. For information
  8. about using Borland SQL Links with Paradox or the 
  9. Database Desktop, see PDOXSQL.TXT.
  10.  
  11.  
  12. TABLE OF CONTENTS
  13. -----------------
  14.  
  15. 1. TIPS FOR USING SQL LINKS
  16. 2. KNOWN PROBLEMS
  17. 3. INTERBASE SQL LINK DRIVER
  18. 4. INFORMIX SQL LINK DRIVER
  19. 5. ORACLE SQL LINK DRIVER
  20. 6. SYBASE SQL LINK DRIVER
  21.  
  22.  
  23.  
  24. 1. TIPS FOR USING SQL LINKS
  25. ---------------------------
  26.  
  27. VENDOR DLLs. If a vendor DLL is not found on the system, 
  28. check the WINDOWS\SYSTEM directory.  
  29.  
  30. USING ALIASES WITHOUT SPECIFYING A LANGUAGE DRIVER.  If 
  31. no language driver is specified, the default language 
  32. driver is ASCII.  Language-specific processes like 
  33. character translation, sorting and table name validation
  34. will default to U.S. rules.  For further information, see
  35. Chapter 3 of Borland SQL Links for Windows Getting Started 
  36. and your driver's Connecting to... manual.
  37.  
  38.   
  39. WORKING WITH LARGE TABLES.  If you create data entry forms 
  40. on large tables you may find some performance degradation 
  41. -- particularly if the user is allowed to view 
  42. unrestricted record sets.  The following suggestions may 
  43. help cut down the load on your server and help optimize
  44. server performance:
  45.  
  46. -  With large data sets, try to write applications which 
  47.    access relatively few records at a time.  One way to do 
  48.    this within a form-based application is to create forms 
  49.    which order the data by index and set range criteria to 
  50.    limit the record set.  (For example, instead of 
  51.    creating a form which displays all orders for all 
  52.    customers, write your application to limit the user's 
  53.    working selection by criteria such as customer name, 
  54.    state, and area code.)
  55.  
  56. -  Where possible, create applications which order on 
  57.    fields which were created with the REQUIRED (NOT NULL) 
  58.    option.  Since this field property must be specified at 
  59.    the time of table creation, be sure to plan for this as 
  60.    part of your application design.
  61.  
  62.  
  63. WORKING WITH "SNAPSHOTS" (TABLES WITHOUT A UNIQUE INDEX
  64. OR ROW ID).  If you insert records into a "snapshot" 
  65. table, you may need to close and reopen the table to see 
  66. your additions.
  67.  
  68.  
  69. 2. KNOWN PROBLEMS
  70. -----------------
  71.  
  72. UPDATING "SNAPSHOTS" (TABLES WITHOUT A UNIQUE INDEX 
  73. OR ROW ID).  When working with a table that does not have
  74. a unique index or row ID, keep the following in mind:
  75.  
  76. - The SQL Links do not support record modifications 
  77.   and deletions on "snapshots" within an explicit 
  78.   client transaction.  Emptying tables is supported 
  79.   within an explicit client transaction, but rolling 
  80.   back such an operation does not update the internal 
  81.   record cache.
  82.  
  83.   To update the record cache, close the table and then
  84.   open it again.
  85.  
  86.  
  87. 3. INTERBASE DRIVER
  88. -------------------
  89.  
  90. CONNECTING VIA FTP PC/TCP.  The connection to InterBase 
  91. via FTP PC/TCP is sensitive to the amount of conventional 
  92. memory available to DOS before Windows is started.  You 
  93. need at least 440 KB to use this connection protocol.
  94.  
  95.  
  96. ADDITIONAL VENDOR DLLs. IUTLS.DLL and DSQL.DLL have been
  97. added.
  98.  
  99.  
  100. ADDITIONAL TRANSACTION ISOLATION LEVEL SUPPORT. 
  101. Read Committed is now supported. 
  102.  
  103.  
  104. SETTING INTERBASE DRIVER FLAGS. Specifying a Read Committed 
  105. transaction isolation level can result in incompatibility with applications using earlier 
  106. versions of SQL Links for InterBase. Earlier versions of SQL 
  107. Links supported Reapeatable Read only. To maintain transaction 
  108. support compatibility with earlier versions of SQL Links, set 
  109. the DRIVER FLAGS option to 512 using the BDE Configuration 
  110. Utility.
  111.  
  112.  
  113. 4. INFORMIX DRIVER
  114. ------------------
  115.  
  116. The Borland SQL Link Informix driver is an ESQL/C 4.x
  117. application. Therefore, you are limited to one connection
  118. per workstation and may encounter some limitations with the 
  119. INFORMIX LDLLSQLW.DLL (version 4.x) file.
  120.  
  121. The Borland SQL Link Informix driver supports INFORMIX-NET
  122. PC Version 4.1.  It does not work with INFORMIX-NET for 
  123. Windows Version 5.01.
  124.    
  125.  
  126. BDECFG AND THE INFORMIX TSR.  The Informix TSR contains 
  127. entries for HOST NAME, USER NAME, and PASSWORD that over-
  128. ride any entries for SERVER NAME, USER NAME, and PASSWORD 
  129. that are set for the Informix driver through the BDE
  130. Configuration Utility.  This is because SERVER NAME, USER 
  131. NAME and PASSWORD cannot be set or changed from within 
  132. your BDE application.  Your BDE application accesses 
  133. the database which is specified in the BDE configuration 
  134. file (usually called IDAPI.CFG), but the server name, user 
  135. name and password will always reflect what was set up 
  136. through the Informix REMSQL or SETNET programs.
  137.  
  138. For ANSI-compliant databases, the user name specified in 
  139. the configuration file is used to qualify object 
  140. names when accessing tables.  If you encounter privilege 
  141. problems, make sure that the USER NAME in your  
  142. configuration file matches the USER NAME that was 
  143. specified when REMSQL or SETNET was executed.
  144.  
  145.  
  146. LIMITATIONS ON OPENING TABLES.  This edition of the 
  147. Informix SQL Link driver does not support opening a table 
  148. with a column name which is an Informix keyword or 
  149. function name.  Some examples include MONTH, DAY, YEAR, 
  150. AVG, COUNT, ALL, and UNIQUE.
  151.  
  152. For a complete list of keywords and function names, see 
  153. your Informix documentation.
  154.  
  155.  
  156. COPYING INFORMIX TABLE WITH INTERVAL COLUMN.  When an 
  157. Informix table with an interval column is copied, the 
  158. destination table is created with an interval which has a 
  159. qualifier of year-to-month.  If this qualifier does not 
  160. match the source table's interval qualifier, you will 
  161. receive an error during the copy.
  162.  
  163. To work around this problem, use pass-through SQL to 
  164. create the destination table with the correct interval 
  165. qualifier.  Then append the contents of the source table 
  166. to the destination table.
  167.  
  168.  
  169. WINDOWS MEMORY PROBLEMS AND CONNECTING TO INFORMIX.  
  170. If there are a number of Windows applications open when 
  171. you attempt to connect to Informix through your IDAPI 
  172. application, you may see Informix error message #837:
  173.  
  174.      Not enough memory available.
  175.  
  176. Exit Windows, then re-start Windows and your BDE
  177. application.  If the problem continues you may need 
  178. more workstation memory.
  179.  
  180.  
  181. INFORMIX ERROR MESSAGES WITH EMBEDDED FORMAT STRINGS.
  182. For certain error messages (such as "Table not found"),
  183. the error message Informix displays will contain an
  184. embedded "%s" instead of a variable name.
  185.  
  186.  
  187.  
  188. 5. ORACLE DRIVER
  189. ----------------
  190.  
  191. SUPPORT FOR QUOTED OBJECT NAMES.  This release of SQL 
  192. Links supports the creation of Oracle tables with quoted 
  193. object names.  Object names which are enclosed in double 
  194. quotes can contain spaces, special characters, reserved 
  195. words, or mixed case.  When querying a table with special 
  196. object names, be sure to enclose the name in double 
  197. quotes; e.g.
  198.  
  199.      SELECT * from "Customer"
  200.  
  201. For more information on object naming rules, see your 
  202. Oracle server documentation.
  203.  
  204.  
  205. ADDITIONAL TRANSACTION ISOLATION LEVEL SUPPORT. 
  206. Repeatable Read is now supported. A Repeatable Read 
  207. transaction is always read-only.
  208.  
  209.  
  210. SETTING ORACLE DRIVER FLAGS. Using mixed-case object names
  211. can result in incompatibility with earlier versions of 
  212. SQL Links for Oracle. Earlier versions of SQL Links used
  213. uppercase object names only. To use uppercase object names
  214. only, set the DRIVER FLAGS option to 1 using the BDE 
  215. Configuration Utility.
  216.  
  217. Specifying a Repeatable Read transaction isolation level
  218. can result in incompatibility with applications using earlier 
  219. versions of SQL Links for Oracle. Earlier versions of SQL 
  220. Links supported Read Committed only. To maintain transaction 
  221. support compatibility with earlier versions of SQL Links, set 
  222. the DRIVER FLAGS option to 512 using the BDE Configuration 
  223. Utility.
  224.  
  225. To use uppercase object names only AND maintain transaction 
  226. support compatibility with earlier versions of SQL Links,
  227. set the DRIVER FLAGS option to 513 (representing 512+1) 
  228. using the BDE Configuration Utility.
  229.  
  230.  
  231. TRANSLATING AN ORACLE DATE FIELD TO dBASE.  In Table 1.8 
  232. of CONNECTING TO ORACLE we state that Oracle DATE fields 
  233. translate to dBASE DATE fields.  They actually 
  234. translate to a dBASE character fields with date and time 
  235. information.
  236.  
  237.  
  238. RUNNING NETINIT.EXE BEFORE STARTING YOUR IDAPI 
  239. APPLICATION.  If you are using SQL*Net for DOS, depending 
  240. on your system memory configuration you may need to load 
  241. the Oracle NetInit program (NETINIT.EXE) before you start 
  242. your IDAPI application.
  243.  
  244.  
  245.  
  246. 6. SYBASE DRIVER
  247. ----------------
  248.  
  249. ADDITIONAL TRANSACTION ISOLATION LEVEL SUPPORT. 
  250. An error (DBIERR_NOTSUPPORTED) is returned if Repeatable Read
  251. is specified. 
  252.  
  253. Specifying a Repeatable Read transaction isolation level can 
  254. result in incompatibility with applications using earlier 
  255. versions of SQL Links for SYBASE. Earlier versions of SQL 
  256. Links supported Read Committed only. To maintain transaction 
  257. support compatibility with earlier versions of SQL Links, set 
  258. the DRIVER FLAGS option to 512 using the BDE Configuration 
  259. Utility.
  260.  
  261. USING DEFAULT SYBASE DRIVER FLAGS SETTING.  If your SYBASE 
  262. SQL Server faults while executing BLOB reads or BLOB 
  263. writes, check the SQL Link driver's DRIVER FLAGS 
  264. parameter.  If DRIVER FLAGS is set to 0 (the SYBASE 
  265. default):
  266.  
  267.   1.  Call SYBASE Customer Support and describe the 
  268.       problem, referencing Case #125046.
  269.  
  270.   2.  Set the DRIVER FLAGS parameter to 1.  Use this 
  271.       DRIVER FLAGS setting until you receive the necessary
  272.       software fix from SYBASE.
  273.  
  274. Setting DRIVER FLAGS to 1 will enable you to execute BLOB 
  275. reads and BLOB writes without causing a server fault.  
  276. This may cause the client to receive SQL Server timeouts 
  277. during BLOB writes.
  278.  
  279. To execute BLOB reads and writes AND maintain transaction 
  280. support compatibility with earlier versions of SQL Links, set 
  281. the DRIVER FLAGS option to 513 (representing 512+1) using 
  282. the BDE Configuration Utility.
  283.  
  284.  
  285. MULTIPLE RESULT SETS.  The Sybase SQL Link driver does not 
  286. support the use of stored procedures that return multiple 
  287. answer sets.
  288.